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ABSTRACT 



A shared registration DLL and configuration data files that 
are used by setup programs and their corresponding appli- 
cation programs to register configuration information in a 
registry and to un-register configuration information from a 
registry. The shared registration DLL simplifies writing and 
synchronizing configuration information registration rou- 
tines in a setup program and in its corresponding application 
program. The shared registration DLL allows for specifying 
relative file system pathnames to the application and to 
application files, rather than requiring file system pathnames 
to be fully specified. The shared registration DLL allows for 
configuration information registered previously by an older 
version of an application to be stored in the registry when a 
newer version of the application is installed, and to be 
restored when the newer version is removed from the 
computer system. The shared registration DLL and configu- 
ration data files allow for incremental addition of configu- 
ration information to the registry when new components for 
a previously installed application are added to (he computer 
system. 
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METHOD AND SYSTEM FOR STORING 2 @= M Drive" 

CONFIGURATION DATA INTO A COMMON 3 "EditFUgs**^ex:d2,0lXK).00 

HEfiiVTRY In the text file, keys are indicated by a text string enclosed 

M3ua ™ Y , tt brackets. "HKEY_LOCAL_ 

TECHNICAL FIELD 5 MACHINE\SOFTWARBaasses\Drive M is the key speci- 

^ . . . . ^ . - . . - ^..^ fled above. The key entries are specified on a line that 

Hie present invention relates to the field of computer W1 ^^^^ 9 ^ v ^ ttm ^^ cn ayv^ 

system support for application program execution, and more „ naincs arc specified by quoted character strings, 

particularly, to a method and system for registering in a The fccy eatry name is spec ified by the char- 

registry various configuration information used at run-time acter A key entry va i ue j s specified either by a quoted 

by application programs. 1 character string or by a value type separated from a specified 

n ArironnTTNn of the invention value b y a cokm * For exam P le - * e s* 00 ^ ^ abovc 

BACKGROUND OF THE INVENTION ^ ^ ^ ^ with mc tev 

The Windows operating system by Microsoft Corporation "HKEY_LOCAL_ 

provides a system-wide registry for storing configuration MACHINE\SOFrWARE\aasses\I>rive" has the character 

information. Application programs, application setup 15 string value 'Drive.** The third line indicates that the key 

programs, and the operating system itself each store their entry named "EditFlags" has an integer value specified as 

own configuration information in the registry. Because the the hexadecimal number d2,Ol,00,O0 (4,043374.592 in 

registry has a pre-defined format and is system-wide, any decimal notation). 

application program can access the information in the reg- An application program retrieves configuration informa- 

istry. Prior versions of the Windows operating system did M tion from the registry during execution to control its execu- 

not have such a registry. Rather, the configuration informa- tion^e application uses specific keys and ke > r entry names 

tion foreachappUcation program was stored in an "INT* file to reference the associated key entry values. For example 

*1 *w ^Jram the application program may use a key entry value to 

for that application program. ^ ^ CQITCSpondmg to a me 

The configuration information in the registry is organized ^ containing a bit-mapped image that the application program 

into hierarchical keys and associated key entries. There are displays m its initial window. The application may also use 

currently six predefined root keys in the registry: "HKEY_ a j™ en(rv va | uc to rc tn CV e parameter settings selected by 

CLASS ES_ROOT, M "HKEY_CURRENT_USER, n me uscr during installation of the application. An application 

"HKEY_LOCAL_MACHENE, n "HKEY_USERS,** program can also add new keys and associated key entries to 

"HKEY_CURRENT_CONFIG, M "HKEY_DYN__ the registry, or change the values of existing key entries. An 

DATA.** These six root keys define six main categories under 30 application program accesses the registry by calling one of 

which sub-keys can be defined. Sub-keys can themselves the several registry function system calls defined in the 

contain further levels of sub-keys. For example, the registry registry application programming interface. Those functions 

might contain the following three keys, each of the three include: RcgEnumKeyEx, which enumerates the sub-keys 

keys comprising the root key , *HKEY_ DW _DATA M and of a specified key; RegOpenKeyEx, which opens and returns 

one sub-key • 33 a handle to a specified key; RegEnumValue, which enumer- 

••hkfy nw nATAVronficManaffer** ates ^ entrics associatcd a specified key; 

HKEY_DYN_J)ArA\ComgManager RegQueryValueEx, which returns the assigned value of a 

HKEY_D YN_D ATA\PerfStats specified key entry; RegSetValueEx, which assigns a value 

"HKEY_DYN_DATA\Security* 1 to a specified key entry, creating the key entry if the key 

Each key and sub-key level are separated by the 'V 40 entry was not previously registered; RegDeleteKey, which 

character, much like a file system pathname specification in removes a key from the registry; and RcgDelete Value, 

the Windows operating system. The registry may contain an which removes a key entry from the registry, 

arbitrary number of hierarchical levels of sub-keys. An Although the registry represents a significant tmprove- 

example of a key having 4 levels is the key: ment over the prior method of storing and retrieving con- 

"HK.EY DYN_DATA/ConfigManager/Enum7 45 figuration information in separate application-specific 

C1121A6C ".INT files, certain problems in using and managing the 

Each key in the registry can have one or more key entries. registry have been recognized. An application is generally 
In addition to having a specific assigned value, each key installed into a computer system by a separate setup pro- 
entry may have a name, specified as a character string, and gram. The setup program collects configuration information 
a value type selected from a number of possible predefined 30 from the user and from the computer system and stores the 

types, including: "REG__SZ" — a character string, "REG collected information into the registry. When the application 

DWORD**— a 32-bit integer specified in decimal notation, is launched following setup, it retrieves the stored configu- 
and W REG„HEX** — a 32 -bit integer specified in hexadeci- ration information from the registry. The application pro- 
ma! notatidn. If no value type is specified for a key entry, the gram itself can subsequently store new configuration inf or- 
key entry has the default value type "RG_JSZ. W Each key 55 marion or change already stored configuration iiiformation 
may have with one default key entry that has no name. in the registry. A serious problem arises if the application 

The Windows operating system provides a program program does not store configuration information in exactly 

("Regedlt**) through which a user can display and edit the the same fashion as the setup program, or expects different 

information stored in the registry. This program also exports or differently specified information than that stored by the 

the information from the registry and stores it in a text file, so setup routine. Although this problem can be alleviated by 

The user can then view the information in the file using a careful coordination of the development of the application 

standard text editor. Each exported key is stored in a separate program and its setup program, such coordination has been 

line in the text file that is followed with a line for each key difficult to achieve. In particular, in the rush to meet devel- 

entry for that key. The following key and associated key opment deadlines, the application program may be changed 

entrics were a part of a text file exported from the registry: 65 to expect certain information in the registry, but the devel- 

1 [ HKEY_LOCAL_ oper forgets to make analogous changes to the setup pro- 

MA(MNE\SOFTWARE\Qasscs\Drive] gram. 
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Another problem arises when a new version of an appli- to store configuration information for the computer pro- 
cation program is installed over an existing version. The new grams in a registry. When a computer program invokes the 
configuration inforrnation repkees tnc configuration stored registration routine; it passes to the registration routine a 
for the earlier version of the program. If the new version of configuration file that contains a description of the configu- 
the application program is then removed, configuration 5 ration information for the computer program. The registra- 
infonnation required by the older version may no longer be tion routine opens the configuration file and adds the con- 
available from the registry, or may be different than that figuration information to the registry. The use of such a 
originally stored by the older version. registration routine provides a solution to the problem of an 

When configuration information is missing or corrupted, application program and its setup program storing configu- 

the older application program can fail to run properly, and ration information in the registry in an inconsistent manner, 

can possibly further corrupt the computer system. Yet in particular, both the application program and its setup 

another problem occurs when file system pathnames program invoke the registration routine, passing to the 

assigned as values of key entries become stale or invalid registration routine the same configuration file. In this way, 

when toe application or the ar^Ucation^s data files for which me rcgistration routilse ^ cnsure mc mnastBDC y of the 

mep^naraes werest^ configuration information. 

location. If, for example, the data files required by an » ^ _ , - ^ , . 

application are moved to the directory "C:\newdirectory." * ***** ***** * e registration 

and the value retrieved from the registry that indicates me r ?, utmc configuraUon information in a way that 

location of the data files is XftoUdirectay," the application aUows 30 °L d version <* ^cation program to execute 

will not find the necessary data files. Finally if new com- con ?^ a acw vcrsion has bccn ^stalled. In 

ponents for an existing application are later distributed, it 20 particular, when a new version of an application program is 

may be necessary to re-execute the entire installation pro- ^faUcd, the registration routine stares the configuration 

cedure to update the registry information and configuration ulformatl l OD for * cw version , * ^ ^ t0 

data files. There is no simple way to incrementally update stonng ^ DCW ^V™*™ information, the registration 

the registry and data files. routme mc * me configuration information for the old 

23 version. When the new version is subsequently un-in stalled, 

SUMMARY OF THE INVENTION an un-registration routine is invoked to un-register its con- 

The present invention provides a registration system for figuration information. When the un-registration routine 

registering configuration information for an application pro- uo-registers, it also restores the configuration information 

gram, A registry is provided that stores configuration infor- 101 °W version. In this way. the old version, when 

rnatioD. The application program has a setup program for 30 executed, will access its correct configuration information, 

storing configuration information in the registry during A preferred embodiment of the invention provides a 

installation of the application program on a computer sys- registration DLL that provides two entry points both to setup 

tern. The setup program invokes a registration routine, programs and to their corresponding application programs 

passing to the registration routine a configuration file that for registering configuration information into the registry 

contains a description of the configuration information to be 35 and un-registering configuration information from the reg- 

loaded Into the registry for the application program. The istry. The program calling the registration DLL to register or 

application program also invokes the registration routine, un-register configuration information provides a data rile 

passing to the registration routine the same configuration having a specific format that contains the configuration 

file. The invoked registration routine opens the indicated information to be registered or unregistered. Hie data file is 

configuration file and retrieves the description of the con- 40 preferably named with a filename having a ".SRG** 

figuration information to be loaded. The registration routine extension, and is known as a self-registration file ("SRG 

then stores the configuration information in the registry file**). The executable routines included in the registration 

based on the retrieved description of the configuration DLL parse the data file and carry out the appropriate 

information. In this way, the setup program and the appli- operations on the registry. The configuration information 

cation program store the configuration information io the 45 may also be provided in a pair of files, one named with a 

registry in a consistent manner. filename having a SKL extension, known as a skeleton file 

BRIEF DESCRIPTION OF THE DRAWINGS ("SKL file^u and one earned with a fUename havmg a TOK 

extension, known as a placeholder file fTOK file"). 

HG. Us a block diagram iUustrating a preferred computer The registration DLL provides a DURegisterServer and 

system that includes the present invention. M DUUnregisterServer routine, which register and un-register 

FIG. 2 displays a flow diagram for DURegisterServer configuration inforrnatioo. A setup program and its corre- 

routine. sponding application program can use a common SRG file 

FIG. 3 displays a flow control diagram for the routine to register and un-register configuration information. They 

Process__key_values. no longer need to implement complex, parallel systems for 

FIG. 4 displays a flow diagram of the subroutine Assign_ 55 soliciting and registoing configuration information, but can 

key__value. use the DURegisterServer and DUUnregisterServer routines 

FIG. 5 displays a flow diagram for the routine DUUnreg- and a common SRG file. 

isterServer. Moreover, when a new component is added to an already 

FIG. 6 displays a flow control diagram for the routine installed application, the user previously was required to 

Process_Jcey. go re-execute die entire installation procedure. With the regis- 

FIG. 7 shows a flow control diagram for the subroutine tratton DURegisterServer routine, a new SRG file that 

Restore_old_values. includes only the configuration information required by the 

new component can be distributed along with the new 
component and the registry can be properly updated by 

63 simply calling DURegisterServer and supplying as an argu- 

A preferred embodiment of the present invention provides ment the pathname of the SRG file containing the configu- 

a registration routine that is invoked by computer programs ration information required by the new component. 
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Previously, installation of a more recent version of an SRG File 

wHcation program overwrote ^^^^^^^ A short example of a SRG file is provided below to 

registered by an earlier version already installed on the *\ 4 . ~* s _ . M ^ A U „*u~ i,^:^ 

computer system. If, for some reason, the newer version of * e fo T* of me me "P 66 ** bv ^trauon 

the application was subsequently un-installed, the registry 5 and un-registration routines: 

information for the earlier version was most likely left in a 

corrupted state by the installation of the more recent version. , fWK vv runums urvm^i 

The DllRegisterServer and DUUnregisterServer routines * ^Ji^ 

solve this problem by saving the earlier version's configu- 3 ©=-Powaftomtshow.r 

ration information under key entries with an **01d" prefix 10 4 

when a more rcccm version is in^ and by staring the * m^S^SSSS^^ 

earlier version s configuration information when the more 7 

recent version is un-installed Furthermore, DllUnregis- 8 [HKOT_ciASSES_ROOl\PDwerft>^ 

terServer recursively removes any parent keys that were SidFikEdiimg\seiver1 

added by the more recent version. 15 • J^^L P^Npowcnmuxe" 

Previously, full file system pathnames were registered by u 

setup programs and application programs. If the application 12 [HKEY_cxASSES^CMM\i^ejp^ 

was subsequently moved to a new location in the file system, , 

it would no longer run, because the registered pathnames £ ^<*™*-< F«M*a«*^ «iv 

were no longer correct The registration DLL automatically 20 15 |HKEY_OJRREOT_USER\&ftware\M^ 

detects the current file system location of a calling 7j0\ 

application, and the SRG configuration data file may include 16 DU ^^fT I ?^L^ 

relative file system pathnames that include placeholders. |J IJ^SS^^Sw^tr 

Each time an application program is executed, it can call i9 «iw="<jbwerPoini Path>ttppttDois4ir 

DllRegisterServer, supplying as an argument the SRG file, 25 ^— — — 

and DllRegisterServer will update key entries that contain 

relative file system pathnames by substituting the current file The format of the SRG file is quite similar to the format 

system location of me application fOT of the text file that is exported from the registry, discussed 

relative pathnames above in thc background. Keys are represented as character 

Because the registry is supported by both the Windows 30 strings enclosed within square bracket^ For ex^le in Une 

•95 and Windows NT operating system^, the same registry 1 of the above example ^™ CLASSES, 

don and im-registmtion^thollogy can be used by appli- 1°™'™*} specifies the key 

cations and semp programs 00 both operating systems, again M^K** *? ^ HKEY_CLASSES_ 

simplifying the writing and coordination of configuration Roar and toc sutHKcy ,ppt 

information collection and registration. Finally, by employ- 35 Following a key specification in the SRG file, there may 

ing SKL and TOK files, rather than a single SRG file, the be one or more key entry assignments. For example, in line 

configuration information can be maintained and managed 3. the default key entry, as designated by the "@ w character, 

separately from the pathname information for a particular is assigned the character string value "PowerPoint Show.7." 

application. The syntax for the assignments is similar to that in the text 

naiisablockolagrammustiatingaprefOTedcoiimutcr 40 file that is exported from the registry, discussed above in the 

system that includes the present invention. The computer background, with the exception that non-character-string 

system 101 contains a central processing unit 102, a memory key entry values are enclosed in quotes. In the text file 

103, and a disk storage device 104. The memory contains exported from the registry, such key entry values are not 
executable code or portions of the executable code for the enclosed in quotes. The key entry to be assigned is identified 
registration DLL 105, application programs 106 and 107, 45 by a quoted character string or by the default key entry 
and the computer operating system 108. The disk storage designator "©."FoUowmg the identification of the key entry 
device contains executable files that comprise permanent is the assignment operator "= n which is, in turn, followed by 
copies of the code for the registration DLL 109, the appli- a specific value to assign to the key entry. The specific value 
cation programs 111 and 112, and the operating system 115. is a quoted string comprising a value type specifier separated 
The disk storage device contains, in addition, SRG files 113 30 by a colon from the specific value. For example, in line 17, 
and 114 used by the application programs to register con- the key entry "AutoLoad" associated with the key "HKEY_ 
figuration information in the registry and the registry file CURREOT_USERVSor^are\niicrosoft\Office\PowerPoint 

104, where the configuration information is stored. The \7.0\DLLAddins\PFTTOOLS" is assigned the integer value 
operating system loads executable code for the applications I. If there is no value type specifier and colon in the quoted 
and the registration DLL into memory from the executable 55 string representing the specific value to assign to the key 
files stored on the disk storage device. The application entry, then the quoted string itself represents the specific 
programs invoke operating system routines in order to value. In line 6, (he default key entry for the key "HKEY_ 
access the various services provided by the operating CLASSESJtOOnPowerPoint Presentation" is assigned to 
system, including routines for reading and writing files. The have the character string value "Microsoft PowerPoint Pre- 
application programs invoke the registration and 60 sentation. H 

un-registration routines provided by the registration DLL to There are three features of the SRG file that are not found 

register and un-register configuration information, passing in the text file exported from the registry. An "Add If 

an indication SRG file that contains the configuration infor- Newer H tag, as shown in line 2, can be inserted before a 

mation to register or un-register. The registration and key-value to indicate that the specified value should be 
un -registration routines of the registration DLL call opcrat- 65 registered only when a more recent version of the applica- 

ing system routines to write information to the registry file tion is being registered. If a more recent version of an 

and read information from the registry file. application is being registered, then the registration DLL 
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automatically saves the previous key entries for each key enclosing the placeholder name in angle brackets, but by 

entry that is being registered In particular, the value of the placing the placeholder name in double square brackets. For 

key entry already registered is assigned to a key entry with example, line 10 of the above example SRG file might occur 

the prefix u 0kT added to the name of the key entry to be in a SKL file as: 

registered. For example, if the most recent version of 5 @=*1 [PowerPointPathN ame ] ]\\powcrpnt exe w 

PowerPoint registered is version 4. then during installation The TOK file consists of a series of placeholder defini- 

of version 7. the registration DLL will process line 3 of the tions. For example, the following line in a TOK file would 

above example by registering a key entry with the key name define the placeholder specified in the above example SKL 

"OLD" and with a value equal to the old default key entry line: 

for the "HKEY„CLASSES_ROOT\.ppr. The registration to ( [PowerPointPathName] ]=PowcrPoint Path 
DLL will then change the value of the default key entry to A SKL file and the corresponding TOK file are merged 
"PowerPoint.7." If the default key entry for the key together into a SRG file by providing them to a simple merge 
M HKEY_(XASSES_ROOT\.ppT was not registered by routine. The resulting SRG can then be provided to the 
the version 4 PowerPoint application, then the registration registration and un-registration routines to register the con- 
DLL will simply register the key entry as specified in line 3. 15 figuration information specified in the SRG file. 

A "Use Short Path" tag can be specified in the SRG file. ^hc Registration DLL 

as illustrated in line 9. When the registration DLL detects _ M . 

this tag, the registration DLL transforms the file system ^ "5***™ DLL provides a registration and an 
pathname that specifies the current location of the applica- un-registration routine that can be called by both setup 
tion to a 8.3 pathname, the former Microsoft standard having 20 programs and by appUca^n programs: DURegisterServer 
filenames of 8 characters or less followed by an extension f d MUnreglsterServer. D^epsterServer is passed con- 
having 3 characters or less. The transformed file system H^on information in a SRG file and registers the coo- 
pathname is then used to construct file system pathnames ZgW*i°* information in the SRG in the registry. DUUnreg- 
that are assigned as values of key entries. This feature is istcrServer is passed configuration information in a SRG file 
useful when the file system that manages the file uses the 83 25 and removes the configuration information in the SRG file 
standi from the registry, restoring old key entries that were saved 

The final feature of SRG files that is efferent from the text when the configuration information was restored, 
file exported from the registry is the occurrence of place- _?? G . 2 J? 0WS a flow *5?5? ^ ^^Server- 
holders within character string values that specify file sys- DURegisterServer parses a SRG file line by line and regis- 
tem pathnames. Aplaceholder is specified within a character » ters key entries specified in key entry assignments, a key 
string by enclosing it within angle brackets. For example, in fntrywas already registered under the same name DUReg- 
line 10 of the above example, "<PowerPoint Path>» is a ^Server saves the already registered key entry in a key 
placeholder. Placeholders indicate that the registration DLL f Qtr ? named by prefixing the word "Old to the name of the 
should replace the placeholder with the file system rename ^ ^ in the key entry assignment, 
of the current location of the application indicated by the 35 111 ste P 201 ^ DURegisterServer determines the file system 
specified placeholder. In the example on line 10, the regis- location of the routine mat called DURegisterServer, and 
tration DLL will replace "PowerPoint Path>" with the saves it in memory for later use. In steps 202-205, DllRcg- 
current file system pathname of the Microsoft PowerPoint isterServer loops searching for the first line mat contains a 
application. Two 'V characters appear in line 10 after the key specification. In step 2t2, DURegisterServer reads the 
placeholder because, in character strings, the T* character 40 Qext ^ fr° m SRG file, starting with the first line. If 
indicates mat any special effects of the character that foUows DURegisterServer determines In step 203 that there were no 
are to be ignored. For example, in order to place a double more tines to read from the SRG file, DURegisterServer 
quote in a character string, the double quote must be returns. Otherwise, DURegisterServer parses, in step 204, 
preceded by a *V character so that the double quote does not * c line read from the SRG file in step 202. If the line is not 
terminate the character string, like, for example, "Here's a 45 a specification, ox, in other words, the line is not the 
character string with a V character." The two *V characters namc of a key enclosed in brackets, as determined in step 
in line 10 arc parsed as a single 'V character, and the entire ^05* DURegisterServer loops to step 202 to read the next line 
character string thus specifies a relative file system path- flom SRG file. Otherwise, DURegisterServer opens the 
name to the file '^powcrpaLexe." Because of the "Use Short specified key in step 206 by calling the system routine 
Path" tag preceding fine 10, the registration DLL wfll 50 RegOpenKey. DURegisterServer determines in step 207 
transfcam the file system pathname specifying the current from Ittum code returned by RegOpenKey whether the 
location of the Microsoft PowerPoint application to an 83 ^ was previously registered in the registry. If the key was 
pathname before substituting it into the character string. not already registered, DURegisterServer creates the key in 
Once the substitution has been made, and the character mc registry in step 208 by calling the system routine 
string parsed by the registration DIX. the registration DLL 55 RegCreateKey and then opens the key in step 209 by calling 
will assign to the default key entry for the key "HKEY_ RegOpenKey. DURegisterServer then calls the subroutine 
CLASSES — Process_Jcey_values to process the SRG lines foUowing the 
ROOT\PowerPomt.Show.7\i*otoco^ key specification and preceding the next key specification in 
the full file system pathname to the file "powerpnLexe." the SRG file. The subroutine Process_Jcey_values returns 
Placeholders thus provide a mechanism for specifying path- 60 TRUE if « after processing the lines, a subsequent key 
names relative to the pathname of the current location in the specification was read from the SRG file, and returns FALSE 
file system directory structure of an application. if no further lines remain to be read in the SRG file. If 

DURegisterServer determines in step 211 that the subroutine 

SKL and TOK Files Proccss_Joey_values has returned TRUE, then DURegis- 

The SRG file can be split into two separate files, a SKL 65 terServer returns to step 206 to open and process the 

file and a TOK file. The SKL file is almost identical to the subsequent key specification. Otherwise. DURegisterServer 

SRG file, except that placeholders are specified not by returns. 
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FIG. 3 shows a flow control diagram for the routine 410 Assign_kcy_valuc determines whether DURegis- 
IVocess _key_values. This routine processes all lines in the terServer has been invoked to register key values on behalf 
SRG up to and including the next key specification, if any. of a more recent version of an application than the latest 
All key entry assignments and tags associated with the key version number for the application stored in the registry. If 
value opened in step 206 of FIG. 2 are handled by Process. 5 a more recent version of the application has invoked 
key_values. In step 301, Process_key_values initializes DllRegisterServer, then Assign Jcey_value registers the 
two Boolean variables new_tag and short_tag to be key entry with the value specified in the key entry assign- 
FALSE. These variables indicate whether a key entry assign- ment read from the SRG file in step 411. If not then 
ment has been preceded by an 4t Add_Jf_New M tag and a Assign_Jcey_value does not register a new value for the key 
'OJse_Short_PauY' tag, respectively. In step 302, Process_ 10 entry. If Assign_key_value determines, in step 409, that no 
key„values reads the next line from the SRG file. If M Add_JLJ*ew" tag preceded the key entry assignment. 
Process Jkey_values determines, in step 303, that the SRG H«n, ™ stc P 412 * Asrign_*ey_value calls the system 
file contains no more lines to read, Process_key_values routine RegSetValueEx to register the key entry with the 
returns FALSE. Otherwise. Process_key__values valuc specified in the key entry assignment read from the 
determines, in step 304, whether the line read in step 302 is 15 SRG file. 

an "Add_Jf_JJew M tag, and, if so, sets the variable new_tag A flow diagram for the routine DUUnregisterServer is 
to TRUE in step 305 and returns to step 302 to read the next displayed in FIG. 5. DUUnregisterServer removes the con- 
line from the SRG file. If the line read in step 302 is an figuration information specified in a SRG file from the 
"Add_Jf_New" tag, then, in step 306, Process _Jkey_ registry, restoring old key entries that were saved when the 
values determines whether the line read in step 302 is a 20 configuration information was registered, and removing new 
u Use_Short_J*ath" tag. If a "Use_Short_J , am w tag path keys and new key entries that were registered when the SRG 
was read in step 302, then Process_key_values sets the was processed by a previous invocation of DllRegis- 
variable short_tag to TRUE in step 307 and returns to step terServer. 

302 to read another line from the SRG file. If a "Use_ In step 501, DUUnregisterServer reads the next line from 
Short_Path w tag was not read in step 302, men Process_ 25 the SRG file, starting with the first line. In steps 501-504, 
key_values determines, in step 308, whether a new key DUUnregisterServer reads successive lines from the SRG 
specification was read in step 302. If a new key specification file until it finds a key specification. If DUUnregisterServer 
was read, then Process_key_values returns TRUE. determines in step 502 that there were no more lines to read 
Otherwise, Process_Jrcy_values determines, in step 309, from the SRG file, DUUnregisterServer returns. Otherwise, 
whether a key entry assignment was read in step 302. If not, 30 in steps 505-507, DUUnregisterServer opens each succes- 
Process _Jcey_valucs returns to step 302 to read the next sive key specified in the SRG file and processes the key 
line from the SRG file, but, if the line read in step 302 is a entry assignments for each opened key. DUUnregisterServer 
key entry assignment, then Process _Jtey_values calls the opens the specified key in step 505 by calling the system 
subroutine Assign_Jcey_value to register the key entry, and routine RegOpenKey. DUUnregisterServer calls the subrou- 
retums to step 302 to re-initialize the variables new_tag and 35 tine Processjjcey in step 506 to process the SRG lines 
short_tag. foUowing the key specification and preceding the next key 

FIG. 4 shows a flow diagram of the routine Assign_key_ specification in the SRG file. The subroutine Process__key 
value. This routine parses each key entry value assignment returns TRUE if, after processing the lines, a subsequent key 
and registers the specified value in the registry. In step 401, specification was read from the SRG file, and returns FALSE 
Assign__key_value parses the key entry assignment that 40 tf no farther lines remain to be read in the SRG file. If 
was read from the SRG file by the subroutine Process_ DUUnregisterServer determines in step 507 that the subrou- 
key_values, oetermining the name and the specified value tine ftocess_J^y has returned TRUE, then DUUnregis- 
for the key entry. In step 402, Assign_key_jvalue deter- terServer returns to step 505 to open and process the 
mines whether there is a placeholder in the value specified subsequent key specification. Otherwise, DllUnregis- 
for the key entry. If a placeholder does occur in the specified 45 terServer returns. 

value, then Assign_kcy_value determines in step 403 FIG. 6 displays a flow control diagram for the routine 
whether a "Use_Short _patrT preceded the key entry Process_key. Hiis routine processes aU Unes in the SRG up 
assignment. If a 44 Use^Short_JPath M preceded the key entry to and including the next key specification, if any. All key 
assignment, the placeholder is replaces with the 83 form of entry assignments and tags associated with the key value 
the current pathname of the routine that caUed DURegis- 50 opened in step 505 of FIG. 5 are handled by Process_key. 
terServer in step 404. In step 601, Process _Jcey clears a buffer to which certain 

Otherwise, the placeholder is replaced, in step 405, with key assignment statements wfll be later written and initial- 
the long form of the current pathname of the routine mat izes the variable old_count to 0, This variable indicates the 
called DURegis terServer. In step 406, Assiga_kEy_value number of key entry assignments saved in the buffer. In step 
calls the system routine RegQueryValueEx to get the regis- 55 602, Process key reads the next line from the SRG file. If 
tered value of the key entry. If no such key entry was Process_key determines, in step 603, that the SRG file 
previously registered, as determined by Assign_Jccy_value contains no more Unes to read. Process^ key calls the 
in step 407, Assign_key_value proceeds to step 411 where subroutine Restorc_old„values in step 604 and then returns 
Assign_Jcey__value calls the system routine RegSetValueEx FALSE. Otherwise, Process_Jcey determines, in step 605, 
to register the key entry with the value specified in the key 60 whether a new key specification was read in step 602. If a 
entry assignment read from the SRG file. Otherwise, in step new key specification was read, then Processjcey calls the 
408. Assign_Jcey_value prefixes the word "Old" to the subroutine Restore_old_values in step 606 and then returns 
name of the key entry to create an old key entry name and TRUE. Otherwise, ftocess_key returns to step 602 to read 
registers the old key entry with the value determined in step the next line from the SRG file. 

406 by calling the system routine RegSetValueEx. Assign. 65 FIG. 7 shows a flow control diagram for the subroutine 
key_value then determines, in step 409, if an "Add_Jf_ Restore_old__values. This routine backs out aU the regis- 
New" tag preceded the key entry assignment. If so, in step trations associated with the open key that were made when 
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DllRegisterServer was previously Invoked with the SRG containing a description of the configuration informa- 

filc. Restore_pld_yalues restores any key entry values tion to be loaded into the registry for the application 

saved with key entry names prefixed with "01d n and recur- program' 

sively removes empty key hier^hies resulting from application program, invoking me 

un-registenng the key entries specified in the SRG. In step 5 . . . ^ , JT . r ^ 

701, Restore_old_values calls the system routine RegE- registrator . routine passing the indication of the con- 

numValue to enumerate the key entries registered for the key figuration file; and 

opened by DllUnregisterServer in step 505 in FIG. 5. Steps under control of the invoked registration routine. 

702-707 represent a loop which iterates over each key entry opening the indicated configuration file, 

enumerated in step 701. In step 703, Restore_old_value$ 10 retrieving the description of the configuration informa- 

determines whether the name of the key entry considered in tion to be loaded and 

the current iteration of the loop 702-706 starts with the storing configuration information in the registry based 

prefix "Old," If the name of the key entry starts with the on the retrieved description of the configuration 

prefix "Old." Restore_old_values removes the prefix "Old* information 

from the key entry name and stores the name without the 15 wherein the setup program and the application program 

prefix and the value assigned to the key entry in a buffer and store the configuration information in the registry in a 

increments old_count In step 705* Restore_old_values consistent manner, 

unregisters the key entry by calling the system routine 2. The method of claim 1 including: 

RegDelete Value, After all the key entries associated witfc 1 the modifying the description of the configuration informa- 

open key have been processed in the loop M ^ staked ^ me configuration wherein both the 

Restore„old_values determines, in step 707, whether the program and the application program store coo- 

variable old count is greater than 0. If it is not Restore. figuration information in the registry in a manner that 

oid_values deletes the open key in step 70S by calling the u ^mistM with the modified description, 

system routine RegDeleteKey to step 709, Restore_old 3 ^ mcthod ^ daim 1 wbcrcm the registry stores 

values removes the last hiemcmc^ level from the name of 25 configuratioil information as key values in a hierarchical 

% the key that was deleted to step 708 .For ^example .if the tescd on a k ^ ±c configuration file 

name of the deleted key was "H^Y^OCAL contains a value for each key to be stored in the registry. 

UACHJ^^F^AK^ClasstsyjyTiytrjxt last ruerarch,- 4. He method of claim 1 wherein the storing of configu- 

cal level "Drive" is removed in step 709 to generate the radon 1^0^^ m the registry further includes: 

parent key "HKEY__LOCAL — 30 . ^ _ ... , . . . , 

MAanNENSOFTWAREXaasses.'' In step 710, Restore. ****** ***** * P revA0US C °fT 3 J*' 

old values determines whether the generated parent key is from " P™*™* ve ™ 011 f *?, a P^ # catl0n 

a root key. In the above example, the root key is the first T «*f** the previous coimguratio« 1 informa- 

rrierarcfeical level ^HKEY_LOCAL MACHINE." If the tion . m * e "tf** 50 ^ previous configuration infor- 

generated parent key is a root key,llestore_old„values 35 v ° 

returns. If the generated parent key is not a root key, then v^ion of toe app^caU(>n pro^ 

Rcstore_old_values opens the parent key, enumerates the ^^thod of daim Iwteeinthe storing of configu- 

key entries associated with the opened key, and enumerates ration infcrmation " mc **** mcludcs: 

the sub-keys of the parent key by calling the system routines when the registry contains previous configuration infor- 

RegOpen Key, RegEnumValue, and RegEnumKey, rcspec- 40 mation from a previous version of the application 

lively. If the variable old_count is greater than 0, then program, retaining the previous configuration inf orma- 

Restore_old_values proceeds, in steps 713-715, to restore tion in the registry when installing a new version of the 

key entries that had been saved by appending the prefix application program so that the previous configuration 

"Oi<T to the original names of the key entries. Steps information can be stored as the current configuration 

713-715 represent a loop that iterates over each key entry 45 information when the new version of the application 

name, specified value pair saved by Restore_old_values in prog 1 ™ is un-installed. 

the buffer in step 704. For each pair, Restore_old_values 6 The method of claim 1 wherein the description of the 

registers the key entry for the open key by calling the system configuration information contains a placeholder for storing 

routine RegSetValueEx. When all the saved key entry name, indication of a file system directory in which executable 

specified value pairs are processed by the loop 713-715, codc °f the application program is stored and including: 

Restore__old_values returns. under control of the invoked registration routine, 

Although the present invention has been described in determining the directory in which the application 

terms of a preferred embodiment, it is not intended that the program is stored; and 

invention be limited to this ernbodiment Modifications replacing the placeholder with an indication of the 

within the spirit of the invention will be apparent to those 55 determined directory so that the stored configuration 

skilled in the art The scope of the present invention is information reflects the directory in which contains 

defined by the claims that follow. mc executable code of the application program. 

I claim: 7. The method of claim 1 wherein the description of the 

1. A method in a computer system for registering con- configuration information contains a placeholder and includ- 

figuration information for an application program, the com- 60 * D 6 : 

puter system having a registry for storing configuration data, under control of the invoked registration routine, 

the application program having a setup program for storing determining information to replace the placeholder 

setup configuration information in the registry during instal- and 

la tion of the application program on the computer system, replacing the placeholder with the determined inf anna* 

comprising: 65 tion so mat the configuration information can be 

under control of the setup program, invoking a registra- dynamically modified during execution of the pro- 

tion routine passing an indication of a configuration file grams. 
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8. The method of claim 1 including: 
under control of the application program, 

retrieving stored configuration information from the 
registry, and 

performing a behavior based on the retrieved configu- 
ration information. 

9. The method of claim 1 wherein the registration routine 
is application program independent. 

10. The method of claim 1 wherein the registration routine 
is invoked by multiple application programs. 

11. The method of claim 1 wherein the configuration file 
is specified in an application-independent format. 

12. The method of claim 1 wherein the configuration file 
contains a flag indicating that the configuration information 
should only be stored if the application program is a new 
version of the application program. 

13. The method of claim 1 wherein the configuration file 
contains a flag indicating that a file system pathname should 
be changed to a different format. 

14. The method of claim 13 wherein the different format 
is an 8.3 format 

15. A computer system fox registering configuration 
information, comprising: 

a registry for storing keys and associated values; 

a configuration file containing a description of configu- 
ration information to be stored in the registry; 

a registration routine for retrieving the description from 
the configuration file and for storing the described 
configuration information in the registry; 

a setup program for invoking the registration routine to 
store in the registry configuration information 
described in the configuration file; and 

an application program for invoking the registration rou- 
tine to store in the registry configuration information 
described in the configuration file and for retrieving 
configuration information from the registry and per- 
forming a behavior based on the retrieved configuration 
information 

wherein the setup program and the application program 
register configuration information in a consistent man- 
ner. 

16. The computer system of claim 15 wherein the registry 
stores the keys are hierarchically organized. 

17. The computer system of claim 15 wherein the regis- 
tration routine determines whether the registry contains 
previous configuration information from a previous version 
of the application program and when the registry contains 
such information, retains the previous configuration infor- 
mation in the registry so that previous configuration infor- 
mation is available during execution of the previous version 
of the application program, 

18. The computer system of claim 15 wherein the regis- 
tration routine determines whether the registry contains 
previous configuration information from a previous version 
of the application program and when the registry contains 
such information, retains the previous configuration infor- 
mation in the registry when installing a new version of the 
application program so that the previous configuration infor- 
mation can be stored as the current configuration informa- 
tion when the new version of the application program is 
un-installed. 

19. The computer system of claim 15 wherein the descrip- 
tion of the configuration information contains a placeholder 
and wherein the registration routine determines information 
to replace the placeholder and replaces the placeholder with 
the determined information so that the configuration infor- 
mation can be dynamically modified during execution of the 
programs. 
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20. A method in a computer system for registering and 
un -registering configuration information of an application 
program, the computer system having a registry for storing 
configuration information for the application program, the 
application program having a new version and an old 
version, configuration information for the old version of the 
application program being registered in the registry, com- 
prising: 

when registering configuration information for the new 

version of the application program, 

saving configuration information for the old version of 
the application program; and 

storing the configuration information for the new ver- 
sion of the application program in the registry; and 
when un-registering configuration information for the 

new version of the application program, 

removing configuration information for the new ver- 
sion of the application program from the registry; 
and 

storing the saved configuration information for the old 
version of the application program in the registry so 
that after un-registering the configuration informa- 
tion for the new version of the application program, 
the old version of the application program can 
retrieve its configuration information from the reg- 
istry. 

2L The method of claim 20 wherein the configuration 
data for the old version of the application program is saved 
in the registry. 

22. The method of claim 20 wherein the registry stores 
configuration information a currently registered version of 
the application program as a key entry having a key entry 
name and a key entry value and wherein the configuration 
information for the old version of the computer program is 
stored in a key entry with a key entry name that is a variation 
of the key entry name for the currently registered version of 
the application program. 

23. The method of claim 22 wherein the variation of the 
key entry name is created by adding a prefix. 

24. A method in a computer system for customizing 
configuration information for an application program to be 
registered in a registry, comprising: 

creating a configuration skeletal file containing configu- 
ration information with placeholders indicating where 
customized configuration information is to be inserted; 

creating a configuration token file containing tokens cor- 
responding to customized configuration information 
replace the placeholders of the configuration skeletal 
file; 

creating a customized configuration file by replacing the 
placeholders of the configuration skeletal file with the 
tokens of the configuration token file; 
opening the customized configuration file; 
retrieving the configuration information from the opened 

configuration file; and 
storing the configuration information in the registry. 

25. The method of claim 24 wherein the configuration 
token file contains configuration information localized to a 
country in which the application program will be executed. 

26. The method of claim 24 wherein the opening, 
retrieving, and storing are performed by a registration rou- 
tine. 

27. The method of claim 26 wherein the registration 
routine is invoked by the application program. 

28. The method of claim 26 wherein the registration 
routine is invoked by a setup program for the application 
program. 
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29. The method of claim 26 wherein the registration 
routine is invoked by both the application program and a 
setup program for the application program. 

3#. A method in a computer system for registering com- 
ponents of an application program after installation of the s 
application program, the computer system having a registry 
for containing configuration information, the application 
program having a configuration file containing configuration 
information for the application program, comprising: 

modifying the configuration file to contain configuration 10 
information describing the component to be installed; 
and 

under control of the application program* 
opening the modified configuration file, 
retrieving from the opened configuration file configu- 15 

ration information describing the component; and 
storing the retrieved configuration information in the 

registry 

so that the component can be automatically installed 
when the application program is executed. 20 

31. A computer-readable medium containing instruction 
for causing a computer system to register configuration 
information for an application program the computer sys- 
tem having a registry for storing configuration data, the 
application program having a setup program for storing 
setup configuration information in the registry during instal- 
lation of the application program on the computer system, 
by: 

under control of the setup program, invoking a registra- ^ 
tion routine passing an indication of a configuration file 
containing a description of the configuration informa- 
tion to be loaded into the registry for the application 
program, the registration routine being invocable by a 
plurality of computer programs; 35 

under control of the application program, invoking the 
registration routine passing the indication of the con- 
figuration file; and 

under control of the invoked registration routine, 
opening the indicated configuration file, 40 
retrieving the description of the configuration informa- 
tion to be loaded, and 
storing configuration information in the registry based 
on the retrieved description of the configuration 
information. 45 

32. The computer-readable medium of claim 31 includ- 
ing: 

modifying the description of the configuration informa- 
tion contained in the configuration wherein both the 
setup program and the application program store con- 50 
figuration information in the registry in a manner that 
is consistent with the modified description. 

33. The computer-readable medium of claim 31 wherein 
the registry stores configuration information as key values in 

a hierarchical manner based on a key and wherein the 55 
configuration file contains a value for each key to be stored 
in the registry. 

34. The computer-readable medium of claim 31 wherein 
the storing of configuration information in the registry 
further includes: 60 

when the registry contains previous configuration infor- 
mation from a previous version of the application 
program, retaining the previous configuration informa- 
tion in the registry so that previous configuration infor- 
mation is available during execution of the previous 65 
version of the application program. 



35. The computer-readable medium of claim 31 wherein 
the storing of configuration information in the registry 
further includes: 

when the registry contains previous configuration infor- 
mation from a previous version of the application 
program, retaining the previous configuration informa- 
tion in the registry when installing a new version of the 
application program so that the previous configuration 
information can be stored as the current configuration 
information when the new version of the application 
program is un-in stalled. 

36. The computer-readable medium of claim 31 wherein 
the description of the configuration information contains a 
placeholder for storing an indication of a file system direc- 
tory in which executable code of the application program is 
stored and including: 

under control of the invoked registration routine, 
determining the directory in which the application 

program is stored; and 
replacing the placeholder with an indication of the 
determined directory so that the stored configuration 
information reflects the directory in which contains 
the executable code of the application program. 

37. A computer-readable medium containing instructions 
for causing a computer system to register and un-register 
configuration Information of an application program, the 
computer system having a registry for storing configuration 
information for the application program, the application 
program having a new version and an old version, configu- 
ration information for the old version of the application 
program being registered in the registry, by: 

when registering configuration information for the new 

version of the application program, 

saving configuration information for the old version of 
the application program; and 

storing the configuration information for the new ver- 
sion of the application program in the registry; and 
when un-registering configuration information for the 

new version of the application program. 

removing configuration information for the new ver- 
sion of the application program from the registry; 
and 

storing the saved configuration information for the old 
version of the application program in the registry so 
that after un-registering the configuration informa- 
tion for the new version of the application program, 
the old version of the application program can 
retrieve its configuration information from the reg- 
istry. 

38. The computer-readable medium of claim 37 wherein 
the configuration data fox the old version of the application 
program is saved in the registry. 

39. The computer-readable medium of claim 37 wherein 
the registry stores configuration information a currently 
registered version of the application program as a key entry 
having a key entry name and a key entry value and wherein 
the configuration information for the old version of the 
computer program is stored in a key entry with a key entry 
name that is a variation of the key entry name for the 
currently registered version of the application program. 

40. Trie computer-readable medium of claim 39 wherein 
the variation of the key entry name is created by adding a 
prefix. 
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